home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 010a / csap311.zip / READ.ME < prev    next >
Text File  |  1991-02-14  |  5KB  |  109 lines
  1.            CSAP - Sort And Pack Directories [C source]
  2.  
  3. Author:  Don A. Williams
  4.  
  5. Version: 3.1.1   Date:    February 14, 1991
  6.  
  7. Made a very minor change to allow CSAP to run under  MS-DOS  5.0.  
  8. The  change  amounted  to nothing more than allowing "5" as a DOS 
  9. version number.  
  10.  
  11. Version: 3.1.0   Date:    July 11, 1990
  12.  
  13. Repaired  a  rather  major  problem  with  the   '-t',   Truncate 
  14. Directories,  option  and  empty  directories.  If  there  was  a 
  15. directory consisting of nothing but erased  files  and  CSAP  was 
  16. executed  WITHOUT the '-t' option and,  later,  CSAP was executed 
  17. WITH the '-t' option, many bad things including corruption of the 
  18. disk could occur!
  19. Also corrected the count of freed clusters which was one too high 
  20. and added a count of the freed bytes to the message.  
  21.  
  22.  
  23. Version: 3.0.2   Date:    June 20, 1990
  24.  
  25. Since  the  absread()  and  abswrite()  functions  provided  with 
  26. version 1.0 of Borland International's Turbo C++ support the long 
  27. sector  addresses required by partitions larger than 32 meg,  the 
  28. special routines used by CSAP are no longer needed and have  been 
  29. removed.  The GetDPB() function was recoded to eliminate assembly 
  30. language at the same time.
  31. Added  a  message  showing  the  number  of clusters freed by the 
  32. "Truncate Directories" option, '-t', and fixed a small bug in the 
  33. truncation routine.  
  34.  
  35. Version: 3.0.1   Date:    June 18, 1990
  36.  
  37. Version 3.0.1 of CSAP is nothing more  than  a  recompilation  of 
  38. CSAP  using  Turbo  C++ 1.0.  It is slightly smaller and slightly 
  39. faster than CSAP 3.0.0.  
  40.  
  41. Version: 3.0.0   Date:    May 11, 1990
  42.  
  43. Version 3.0.0 of CSAP can handle MS-DOS  4.xx  and  DR  DOS  3.xx 
  44. large  partitions.  It  also  introduces  the optional ability to 
  45. truncate directories,  i.e.  release unused directory disk  space 
  46. back to the free space pool.  CSAP now uses Chris Blum's Absolute 
  47. Disk  I/O  modifications  but  only  the OBJ file for the Compact 
  48. model in  included  in  the  CSAP  ZIP.  The  entire  package  is 
  49. available  on  CompuServ  in  IBMPRO  Library  #3  as ABRD40.ARC.  
  50. Version 3.0.0 of CSAP MUST be regarded as a "beta test" version - 
  51. there are now many different possible configurations and  I  have 
  52. not  been  able to test them all.  It has been tested with MS-DOS 
  53. 3.3 on the small partitions that 3.3 can handle and  with  MS-DOS 
  54. 4.01  and DR DOS 3.41 on small partitions and on large partitions 
  55. up to 70 meg.  I would highly recommend that you take a full save 
  56. of your hard disk before using CSAP 3.0.0 until you are sure that 
  57. it works with your particular setup.  
  58.  
  59. Version 2.1.1 of CSAP corrects the incorrect sorting on Date/Time 
  60. that was reintroduced in CSAP 2.0.9 and  later  versions.  Thanks 
  61. to David Klatzco for reporting it.  
  62.  
  63. Version 2.1.0 of CSAP corrects the handling of the '.'  and  '..' 
  64. directory  specifiers  and  adds  the  documentation  of the '-V' 
  65. option to CSAP.DOC (the '-V' has been operative in  the  program 
  66. for some time but was left out of the documentation.) 
  67.  
  68. CSAP  is  composed of 5 modules;  CSAP.C,  SORTDIR.C,  ISDEV.C.C, 
  69. GETDPB.C,  and ABSREAD.OBJ.  The current version  of  CSAP,  CSAP 
  70. 3.0.0ß,   has   been   designed   for  compilation  with  Borland 
  71. International's  Turbo  C  2.0.   The  module  ISDEV.C  could  be 
  72. replaced by Turbo C's supplied function isatty(), however, I plan 
  73. to extend ISDEV.C to distinguish among files,  CON,  AUX, and the 
  74. printer.  The function isatty() just distinguishes between  files 
  75. and the others.  
  76.  
  77. GETDPB.C cannot be compiled in Turbo C's interactive  environment 
  78. (TC).  It  is  primarily  inline  ASM  code and requires the more 
  79. conventional environment provided by Turbo C's TCC command.  As a 
  80. result,  CSAP was designed to be compiled through the  use  of  a 
  81. MAKEFILE and the MAKE facility of Turbo C.  
  82.  
  83. CSAP currently compiles and executes correctly in  any  of  Turbo 
  84. C's  supported  memory  models  except HUGE.  The memory model is 
  85. defined as a macro in the MAKEFILE and is supplied  on  the  MAKE 
  86. command line, i.e.: 
  87.  
  88.         MAKE -DMDL=s
  89.  
  90. to make a SMALL memory model version of CSAP  (the  "s"  must  be 
  91. lower  case  since  it  is  a  parameter  to  TCC and TCC is case 
  92. sensitive on its parameters).  The resultant  EXE  file  will  be 
  93. named  CSAPx.EXE where 'x' is C,  S,  M,  or L depending upon the 
  94. memory model selected.  The default memory model (if -DMDL is not 
  95. specified on the MAKE command) is the COMPACT model.  The current 
  96. MAKEFILE will NOT work properly for the TINY  memory  model,  the 
  97. library  specifications in the MAKEFILE would have to be modified 
  98. to use the SMALL libraries for the TINY model and the  effort  is 
  99. probably not worth it.  The command: 
  100.  
  101.         TCC -mt -G csap sortdir isdevice getdpb
  102.  
  103. would  have  to be used to produce a TINY memory model version of 
  104. CSAP and would produce an EXE file with the name CSAP.EXE.  
  105.  
  106. The  EXE  and OBJ files in the CSAPxxx ZIP have been produced for 
  107. the COMPACT model which is probably the most general.  
  108.  
  109.